home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 1.iso / dist / fw_cyrus-sasl.idb / usr / freeware / catman / p_man / cat3 / sasl_server_start.Z / sasl_server_start
Text File  |  2001-07-06  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. sasl_server_start(26 March 2000) sasl_server_start(26 March 2000)
  5.  
  6.  
  7. NNAAMMEE
  8.        sasl_server_start - Begin an authentication negotiation
  9.  
  10.  
  11.  
  12. SSYYNNOOPPSSIISS
  13.        ##iinncclluuddee    <<ssaassll..hh>>
  14.  
  15.        iinntt ssaassll__sseerrvveerr__ssttaarrtt((ssaassll__ccoonnnn__tt ** _c_o_n_n,,
  16.                 ccoonnsstt cchhaarr ** _m_e_c_h,,
  17.                 ccoonnsstt cchhaarr ** _c_l_i_e_n_t_i_n,,
  18.                 uunnssiiggnneedd ** _c_l_i_e_n_t_i_n_l_e_n,,
  19.                 cchhaarr **** _s_e_r_v_e_r_o_u_t,,
  20.                 uunnssiiggnneedd ** _s_e_r_v_e_r_o_u_t_l_e_n,,
  21.                 ccoonnsstt cchhaarr **** _e_r_r_s_t_r));;
  22.  
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.        ssaassll__sseerrvveerr__ssttaarrtt(())  begins  the     authentication     with the
  26.        mechanism specified with    mech. This fails if the    mechanism
  27.        is  not    supported. SASL_OK is returned if the authentica
  28.        tion is complete    and the    user is    authenticated.    SASL_CON
  29.        TINUE  is returned if one or more steps are still required
  30.        in the authentication. All other     return     values     indicate
  31.        failure.
  32.  
  33.        _c_o_n_n  the SASL context for this connection _m_e_c_h the mecha
  34.        nism name that the client requested _c_l_i_e_n_t_i_n  client  ini
  35.        tial response, NULL if empty _c_l_i_e_n_t_i_n_l_e_n    length of initial
  36.        response    _s_e_r_v_e_r_o_u_t is created by    the library.  It  is  the
  37.        initial    server    response  to  send to the client. This is
  38.        allocated for by    the library and    it  is    the  job  of  the
  39.        client  to  send     it  over the network to the server. Also
  40.        protocal    specific encoding (such    as base64 encoding)  must
  41.        needs  to  be  done by the server.  _s_e_r_v_e_r_o_u_t_l_e_n    length of
  42.        initial server challenge    _e_r_r_s_t_r is set to a string to send
  43.        to the user on failure
  44.  
  45.  
  46.  
  47.  
  48. RREETTUURRNN VVAALLUUEE
  49.        sasl_server_start  returns an integer which corresponds to
  50.        one of the following codes. SASL_CONTINUE indicates sucess
  51.        and  that  there     are more steps    needed in the authentica
  52.        tion. All other return codes indicate  errors  and  should
  53.        either  be handled or the authentication    session    should be
  54.        quit.
  55.  
  56.  
  57.  
  58. EERRRROORRSS
  59.        SSAASSLL__CCOONNTTIINNUUEE
  60.            Success.    keep going.
  61.  
  62.  
  63.  
  64. SASL man pages               SASL                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sasl_server_start(26 March 2000) sasl_server_start(26 March 2000)
  71.  
  72.  
  73.        SSAASSLL__IINNTTEERRAACCTT
  74.            user interaction    needed    to  fill  in  prompt_need
  75.            list
  76.  
  77.        SSAASSLL__BBAADDVVEERRSS
  78.            Mechanism version mismatch
  79.  
  80.        SSAASSLL__BBAADDPPAARRAAMM
  81.            error in    config file
  82.  
  83.        SSAASSLL__NNOOMMEEMM
  84.            not enough memory to complete operation
  85.  
  86.  
  87. CCOONNFFOORRMMIINNGG TTOO
  88.        RFC 2222
  89.  
  90. SSEEEE AALLSSOO
  91.        ootthheerrsaslssttuuffff
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. SASL man pages               SASL                2
  131.  
  132.  
  133.